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INTERNALS OF A VAX/VMS PROCESS 


A process is the environment within which programs execute 
on VMS. It is made up of a hardware context (e.g. general 
registers), software context (@.g. privileges, quotas), and vir- 
tual address space. This seminar provides an indepth jook 
at the structure and function of VMS processes. 


The discussion will include information on how a VMS pro- 
cess is implemented, scheduled and maintained. This will 
assist in using VMS processes more efficiently in applications. . 


in addition, this information will give system managers a better 
understanding of the resources required for processes, and 
how to manage those resources. 


The seminar wiil reflect the most recent version of VMS. 


Topics: 

© The major internal data structures used by VMS to describe 
and contro! a process 

© Tools provided by VMS for examination of processes 

© Process scheduling © 

¢ Quantum end activities 

© Exarnination of relevant VMS source code in MACRO32 
(if there is sufficient class interest) 


information on image formation and activation will be included 
if time permits. 


Prerequisites: 

Experience with VMS at the OCL level. Fundamental 
knowledge of a process (received through programming, 
design or system management). Experience with data struc- 
ture, definition and manipulation. 


SEMINAR TOPICS 
1. THE PROCESS 
o Process vs System Context 
Oo Process Data SErueEMEeS 


“Oo Virtual Address Space 


2. PROCESS CREATION AND DELETION 
o Steps in Process Creation 
o Interactive vs Batch Jobs 


Oo Process Deletion. 


3. PROCESS SCHEDULING 
Oo Process States and Data Structures 
© Operating System Scheduling Code 


Oo Quantum End 


THE PROCESS 


TOPICS 
I. Process vs. System Context 


Il. Process Data Structures Overview 


A. Software context information 


B. Hardware context information 


III. Virtual Address Space Overview 


A. S@ space (operating system code and data) 
B. P@ space (user image code and data) 


Ce “PL space (command language interpreter, process data) 


IV. SYSGEN Parameters Related to Process Characteristics 


$ SHOW SYSTEM 


VAX/VMS V4.0 on node MUSIC 30-NOV-1984 11:04:10.58 
Process Name 


Pid 
00000080 
00000081 
00000085 
00000088 
00000089 
0000008B 
0000008C 
0000018D 
OO00008F 
00000090 
00000091 
.00000112 
00000213 
00000214 
00000115 
00000116 
00000117 
00000118 
0000011B 
00000120 
OOO0001BE 


NULL 
SWAPPER 
ERRFMT 
OPCOM 

JOB CONTROL 


SYMBIONT_0001 
SYMBIONT 0002 | 


MOZART 
NETACP 
EVL 
REMACP 
HUNT 
CHOPIN 
BATCH 931 
STRAVINSKY 
HAYDN 
COPELAND 
SOUZA 
BEETHOVEN 
SALIERI 
MAIL 12 


State 


COM 
HIB 
HIB 
LEF 
LEF 
HIB 
HIB 
LEF 
HIB 
HIB 
HIB 
CUR 
LEF 
LEF 
LEF 
LEF 
LEF 
LEF 
LEF 
LEF 
LEF 


Pri 


: ~~ 


I/o CPU ; 
0 0 10:53:07.27 
0 0 00:03:17.21 
760 0 00:00:07.71 
378 0 00:00:03.96 
2281 0 00:00:33.34 
448 0 00:00:31.56 
19 0 00:00:00. 66 
190 0 00:00:10.74 
4892 0 00:01:37.36 
32 0 00:00:00.82 
71 0 00:00:00. 45 
3663 0 00:01:30.36 
450 0 00:00:10.12 
376 0 00:00:16.94 
2404 0 00:00:29.46 
686 0 00:00:15.19 
4121 0 00:01:08.54 
819 0 00:00:13.84 
719 0 00:00:11.59 
856 0 00:00:13.26 
380 0 


00:00:05.24 


Uptime 
Page flt 


0 13:44:50 
s Ph.Mem 
0 0 
0. 0 
67 88 
1184 135 
149 293 
2465 44 
- 235 45 
6552 150 
3216 1500 
253 44 
72 41 
29430 200 
Slil 300 
6077 - 260 
8336 148 
7480 400 
17151 154 
2862 150 
4970 500 
4855 500- 

1014 


215 
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PROCESS VS. SYSTEM CONTEXT 
Process Context 
e Software Context, including 
- Privileges 
- Quotas 
- Scheduling priority 
.-° IDs (user name, UIC, Process ID) 
@ Hardware Context, including 
- General Purpose Registers (R@- R11, AP, FP, PC) 
- Stack pointers (4) 
- Processor Status Longword (PSL) 
e Virtual Address Space 
2 program region (P@) 


- Control region (Pl) 


_o System region (S6) 


System Context 


e System virtual address space (SQ) 


e The interrupt stack 


THE PROCESS 


VIRTUAL ADDRESS SPACE OVERVIEW 


SEPARATE MAPPING 
FOR EACH PROCESS 


ONE MAPPING FOR 
ALL PROCESSES 


TK-8942 


Figure Virtual Address Space 


Process Virtual Address Space 
P@ - Image, Run-Time Library, Debugger 


Pl - Command Language Interpreter, 
stacks, file system XQP, I/O data areas 


S@ - System services, Record Management 
Services, other executive code and 


data 
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PROCESS DATA STRUCTURES OVERVIEW 





S@ SPACE 
HAROWARE 
PROCESS 
CONTROL 
BLOCK 
JOB SOFTWARE 
INFORMATION : PROCESS 
BLOCK i. CONTROL 
(JIB) BLOCK 
| (PCB) 
PROCESS 
HEADER (PHD) . 
Figure Process Data Structures 


e Software Process Control Block (PCB) 


- Holds process-specific data that must always be 
available (for example, process state, priority). 
- Contains pointers to other process data structures 
- Not paged, not swapped 
@ Process Header (PHD) 


- Contains process memory management information 
- Contains hardware process control block 


@ Hardware Process Control Block 


- Contains saved hardware context 


@ Job Information. Block (JIB) 


- Keeps track of resources for a detached process and 
all its subprocesses. 


1. 


THE PROCESS 


Software Process Control Block (PCB) 














STATE QUEUE FORWARD LINK 
STATE QUEUE BACKWARD LINK 


@ VMS standard queue 
header . 

e Size of nonpaged 
pool allocation 


| Scheduling information 










Pp 
SCHEDULING ; coe 
INFORMATION Resident/outswapped 

Swap/noswap 
7 . @ State 
R 
| RESOURCES eerie re 
. @ Subprocess count 

Point to: 

POINTERS TO Mee prose iaaie: 

OTHER DATA : Hardware PCB 

e Ji8 

STRUCTURES @ Event flag clusters 

Listheads AST queue _ 


LISTH EADS 


NAMES AND PRIVILEGES 


. Lock queue 


Names and Privileges 


@ Process 1D (P10) 
@e Login UIC 
@ Privilege mask 
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Figure J] Software Process Control Block (PCB) — 
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PCBSW_GPGCNT 
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PCBST_TERMINAL 


PCB$L_POB 
PCBSL_EFCS 
PCBSL_EFCU 
PCBSW_PGFLCHAR 
PCB$B_PGFLINDEX 
unused 
PCB$L_SWAPSIZE 
PCBSL_EFC2P 
PCBSL_EFC3P 
PCBSL_PID 
PCBSL_EPID 
PCBSL_EOWNER 
PCBSL PHD 


PCB$T_LNAME 


PCBSL_JIB 


PCB$O_PRIV 


PCBSL_ARB 


unused 


PCBSL_UIC 


unused 


PCBSL_ACLFL 
PCBSL_ACLBL 
PCBSL_LOCKOFL 


PCBSL_LOCKOBL 
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PCBSL_EFWM 


PCBSW_MEM... 


PCBSL_DLCKPRI 
PCB$L_IPAST 

PCB$L_DEFPROT 
PCBSL_WAITIME 


PCBSL_PMB 
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THE PROCESS 
Process Header (PHD) FoR Gude =o Fn CR SS 


© Privilege mask 


FIXED AREA @ Hardware process controi 
block 
UxT OCF YRTUTE 
CATALOG WORKING SET PAGES | © Working set list face . OSED Deda 
Sw AaPrnreG - os 


Ae Pee Cekay HAVE 


SAME Sia PACCRAN Mi 


USED TO LOCATE IMAGE 
SECTIONS IN IMAGE FILES 


@ Process section table 


TRaws twAT HC Mo 

TABU - 7 
VIRTUAL TO PHYSICAL © PO page table 

' ADORESS MAPPING © P1 page table 
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Figure A Process Header (PHD) . 
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Hardware Process tials Block Book Mw dh frre 


Cowon 
STACK POINTERS 


GENERAL PURPOSE 
REGISTERS 


OTHER REGISTERS 
STATUS INFORMATION 


MEMORY MANAGEMENT 
REGISTERS 





witho AMM CPU, aM Finn one eypre/ 


PRS__PCBB 
© Pointers to: 


~ Kernel stack — © ee 
— Executive stack — AM-> 
— Supervisor stack —— >C'~- 
- User stack __ agg - ; 


Pape y whit wa 
cee des Gol ate Gia OP 


e 6RO, RI, ..., R11 


+0 2 


eaenee 
oO oi e 


(tee 


e@ Argument Pointer (AP) 
Frame Pointer (FP) 
Program Counter (PC) 
@ Processor Status Longword (PSL) 


@ PO base register 
P1 base register .: 7 
PO length register ¢ Maye An ys Uni wor poe 


-P1 length register > 4 FACUELEL . - _ 
i CAtkes Benes Ugustiv 
But tiv BAtlas porrebry v 
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Figure 3 Hardware Process Control Block 


@® ,PRS_PCBB contains the physical address of the hardware PCB 


for the current process. 
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Job information Block 









RESOURCES 
& LIMITS 


DETACHED 


PC8 JOB INFORMATION 


BLOCK (JIB) 
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Figure 4 Job Information Block (JIB) 


@ Job consists of a detached process and its subprocesses. 


e Job information block (JIB) keeps track of resources 
_ allotted to a job, such as: 


- Limit on number of subprocesses (PRCLIM) 
- Open File Limit (FILLM) 


a aie 
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SO Virtual Address Space » Ww Ak is 
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S@ Virtual Address Space 


Figure 5 
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STACK USED WHEN 
INTERRUPTS OCCUR 


TABLE FOR VECTORING 
BY HARDWARE TO 
SERVICE ROUTINES 





STORAGE FOR 
PROCESS HEADERS 


LOCATIONS OF VALID 
SYSTEM VIRTUAL ADDRESSES 


DATA STRUCTURES USED 
TO LOCATE GLOBAL SECTIONS 


LOCATION OF EACH 
PAGE OF SYSTEM 
VIRTUAL ADDRESS SPACE 


LOCATIONS OF 
GLOBAL PAGES . 


Figure b 
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e interrupt stack 
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e System header 
- System working set list 
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e System page table 


@ Global page table 
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PO Virtuat Address Space 


W iT 
Native Mode Image eae 6 mi : Donk tT LAs . 7 
2 Rie PY ~ LEGS © - ; che i ¥ 
BR cam Ceci 









Native Mode image 


Run Time Library 
Oebugger | 


Traceback 


not mapped 





POLR Pages 
SFFFFFFF 


Figure 7 P@ Virtual Address Space 
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P1 Virtual Address Space UMS Sips fb. FoAmATS “ti es 
Qu Ay weber ab Cr hgnrr ASD Vi GURIS ofr }- c 


¢ 
User Stack 


Per-Process Messace Section (s 


CLI Symbol Tabie 


Wationae 7 }o CTLSGL_F118xaP 
Files-11 XQP Fic ofr, : 


rat ws uf a 
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image 1/0 Segment 
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eek Ch AaAninee So- 
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P1 Window to Process Header 
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Per Process Common Area 


40000000 
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Figure 38 Pl Virtual Address Space - Hégtr Addresses 
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— @ CTLSGL_CMCNTX 
Compatibility Mode Data Page NSAST_IOT 
Security Auditing 


T 
impure Date Table 4 CTLSGL_IAFLINK 


|___ image Activator Context | 
Generic CL! Data Pages CTLSAL_CLICALBK 


image Activator Scratch Pages 


Oebugger Context CTLSA_DISPVEC 


Vectors for ite nd User-Written System Servic 
a —— —— leader ———— _  MMG$GL_IMGHORBUF 
[Kernel Stack 
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= v 
P1 Pointer Page SESSt ECTORS 





Debugger Symbol Tabie 
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Figure 9 Pl Virtual Address Space - Low Addresses 


Image-Specific - Deleted on image exit 

Process-Specific - Changes according to SYSGEN parameters. 
| and CLI used 
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. Table 1 Punction of Pl Space | 
RE A AS aaa aaa caarna aa cacaraammmamaaaasacacmmaaaaaatacaa 


Function 


Images 
Symbol tables 


Pointers 


Stacks 
RMS data 


File system code 
Error message text 


Storage area 


@ Data stays around . 


between images 
@® Logical names 


Other data areas 


Pl Area 


Command Language Interpreter 
(DCL, MCR, user-written) 


Symbolic Debugger 


Command Language Interpreter 


System service vectors 
User-written system service 
vectors 


Pl window to process header. 
(maps to PHD in SO space) 


Pl pointer page (i.e., . 
CTLSGL_CTLBASVA; addresses 
of exception vectors) 

Perprocess message vectors 


Kernel, executive, supervisor, 
user 


Image I/O segment 
Process I/O segment 


Files-11 XQP 


Perprocess message section 


Perprocess Common Area 
(LIBSGET_COMMON ) 


Process allocation region 


Generic CLI data pages 


Image activator scratch pages 
Image header buffer 
Compatibility mode data page 
(used by AME) 

Channel control block table 
(links process to device) 
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Table 2 SYSGEN Parameters Relevant to Process Structure 





Function . Parameter 
Size of the CLI symbol table CLIS YMTBL 
Limit on use of process allocation region by - CTLIMGLIM (*) 
images 

Number of pages in the process allocation CTLPAGES (*) 
region 


Default number of: pages created by the image IMGIOCNT (*) 
activator for the image 1/0 segment ; 


Number of pages for the process I/O segment - PIOPAGES (*) 
mapped by PROCSTRT 
hd a a 8 


(*) = special SYSGEN parameter 
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TOPICS 


I. Process Creation | 


A. Roles of operating system programs 


B. Creation of process data structures 
II. Types of Processes 


III. Initiating Jobs 


A. Interactive 


B. Batch 


IV. Process Deletion 


V. SYSGEN Parameters Relating to Process Creation and Deletion 
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PROCESS CREATION AND DELETION 


. TYPES OF PROCESSES 


Table 3 Types of Processes 
Se a a eS aaa aeaaaaaaaaasccaascmmmasaaaamammmmsammed 





Created Creating Special 
By Code Properties 
Batch Job Controller SUBMIT, - Deleted upon logout, 
SSNDJBC, or at end of command | 
SCREPRC stream 
- NO password check 
Detached Another RUN, $CREPRC - Survives deletion of 
process : 1ts creator 
- May be interactive 
or not 
Network — Network ACP = $CREPRC - Deléted when no more 
(result of DCL ‘logical links to- 
command with service 


node name) 


Subprocess Another RUN, SPAWN, - Cannot survive 
| process (the LIBSS PAWN, - deletion of owner 
owner) © SCREPRC - Quotas are pooled 


with owner 
~ May be interactive 
or not 





@ RUN and SPAWN call SCREPRC 


e After system initialization 


- A process is. created by another process 
- Process creation is done by SCREPRC 


@ An interactive process has: 


- PCBSV_INTER bit set in PCBSL_STS field 
- Non-file-oriented SYSSINPUT 


a4 











PROCESS CREATION AND DELETION | 


Table 4 pcs Fields Defining Process Types 


PCBSV BATCH PCBSV_NETWRK PCBSV_INTER PCBSL_OWNER 


Network 1 g G 
Batch 1 g g 6 
Detached g 6 g Or 1 g 
Subprocess g g . @ orl non-zero 





@ PCBSV_xxx symbols represent bits in PCBSL_STS longword 
e These bits in the status Longword | 
- Are intended ONLY for use by the system (for example, the 
job controller or SPAWN) 
- Can be set using STSFLG argument to SCREPRC 


@ Interactive processes have the PCBSV_INTER bit set 


Table 5 Restrictions on Process Creation 





Quota/Limit, Meaning 


Q 


MAXJOBS Maximum number of interactive, detached, and batc 
processes a user may create 





MAXDETACH. Maximum number of detached processes a process 
may create 
PRCLM Limit on number of subprocesses a process may 
| create : , 
Privilege - Required for 
DETACH or - Creation of a detached process with a different 
CMKRNL UIC than the creator 
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SCREPRC 


The Create Process service creates a subprocess or detached. process 
on behalf of.the calling process. 


Formats: 


-SYSSCREPRC [pidadr] ,image [,input] [,output] (,error] 
{,prvadr] [,gquota] [,prcnam] [,baspri] [,uic] 
{,mbxunt] [,stsflg] | 


Arguments :. 
pidadr 


Process identification (PID) of the newly created process. The 
pidadr argument is the address of a lonqword into which S$CREPRC 
writes the PID. 


image 


Name of the image to be activated in the newly created process. The 
image argument is the address of a character string descriptor 
pointing to the file specification of the image. 


input 


Equivalence name to be associated with the logical name SYSSINPUT in 
the logical name table of the created process. The input argument 
is the address of a character string descriptor pointing to the 
equivalence name string. 


output 


Equivalence name to be associated with the logical name SYSSOUTPUT 
-in the logical name table of the created process. . The output 
argument is the address of a character string descriptor pointing to 
the equivalence name string. 


error 

Equivalence name to be associated with the logical name SYSSERROR in 
the logical name table of the created process. The error argument 
is the address of a character string descriptor pointing to the 
equivalence name string. | 

prvadr 

Privileges to be given to the created process. The: prvadr argument 


is the address of a quadword bit vector wherein each bit corresponds 
to a privilege; setting a bit gives the privilege. 


Vo 











quota 


Process quotas to be established for the created process; these 
quotas limit the created process's use of system resources. The 
quota argument is the address of a list of quota descriptors, where 
each quota descriptor consists of a l=-byte quota name followed by a 
longword that specifies the desired value for that quota. The list 
of quota descriptors is terminated by the symbolic name 
POLS _LISTEND. 7 


prenam 


Process name to be assigned to the created process. The prcnam is 
the address of a character string descriptor pointing to a l- to 
15-character process name string. 


baspri 


Base priority to be assigned to the created process.. The baspri 
argument is a longword value in the range 0 to 31, where 31 is the. 
highest possible priority and 0 is the lowest. Normal priorities 
are in the range 0 through 15, and real-time priorities are in the 
range 16 through 3l. 

uic 
User identification code (UIC) to be assigned to the created 
process. The uic argument is a longword value containing the UIC. — 


mbxunt 

Unit number of a mailbox to receive a. termination message when the 
created process is deleted. The mbxunt argument is a longword 
containing this number. - 
stsflg 

Options selected for the created process. The stsflg argument is a 


longword bit vector wherein a bit corresponds to an option. Only 
bits 0 to 10 are used; bits 11 to 31 are reserved and must be 0. 


al 
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PROCESS CREATION 


fable | Steps in Process Creation and Deletion 








Action Code 
Creating process SYSSCREPRC 
tnawap a process SWAPPER 
Process startup PROCSTRT 
Process deletion SYSSDELPRC 





Table 7 Three Contexts Used in Process Creation 








Creator's % Swapper's New Process's - 
Context Context . Context 

SCREPRC From SHELL PC= EXESPROCSTRT 

@ PCB | PHD filled in PSL= K mode, IPL=2 

e JIB COMO --> COM __... Sets _up: 

@ PQB (temp) . -~ logical names (sysSinput...) 


Catch-all cond. handler 
RMS dispatcher . 
XQP merged in 

Image name moved to PHD 
Image activated 


SW priority 
boost 


Process re=. 
turned COMO 
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__. Creation of PCB, JIB, and PQB 











Ji8 


(Pooled: 
Quotas) 






Creator 













New Process 






$CREPRC 
arguments 








Control 


Region 
g Process 


-Quota 
Block 











(PQs) 
Process . 
Header 


Figure !0 Creation of PCB, JIB and PQB 





SCREPRC allocates new data structures 


- PCB 
- JIB (if new process is detached) 
- PQB (temporary) 


These new data structures. are filled from: 


SCREPRC arguments 
Creator's PCB 

Creator's control region 
Creator's process needer 
System defaults 


*SYSGEN - 


PQL_xxxx parameters 


aq 
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_. Relationships Between PCBs and JIB 





Figure ll Relationships Between PCBs and JIB 


1. All PCBs point to JIB 
W created X and Y 


2. W's PRCCNT is 2 


3. X and Y owner PID is W PID 


Y created Z. 


No pointers from creator to subprocess 
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PCB Vectoe™ . —_—~—_:—i. 


Figure 12 PCB vector 


@® On process creation, search for unused vector 


@e Unused vectors point to Null's PCB 


@e Table of pointers to all PCBs 


@ Index into table is contained in PID 


e SCHSGL_PCBVEC points to start of table 


*SYSGEN - 


MAXPROCESSCNT 


3! 
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_ PID and PCS, Sequence Vectors 





Figure 13 PID and PCB, Sequence Vectors 


@ Extended PID contains four parts: 


- ‘Process index into PCB and sequence vectors 
‘= Process sequence number 
- Cluster node index 
- Node sequence number 
@ PID formed at process creation 
@ Sequence number incremented each time vector slot re-used 


@ SCHSGL_SEQVEC points to start of sequence vector 
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Process IDs 


e There are actually two PIDs for a process — 
e@ Extended PID 


- Visible at the user level 


- Uniquely -identifies a Process on a single system, and 
on a VAXcluster 


- Displayed by VMS utilities and system services 
- Stored in PCB at offset PCBSL_EPID 
- Format is very subject to change 
e Internal PID 
* Only visible through SDA, and in VMS source code 
- Stored in PCB at offset PCBSL_PID 


- Only contains process index and sequence number 
(original pre-v4 PID) 


- Used by most kernel-mode code 


- Some privileged data structures contain internal PIDs 
(for example TQESL_PID, ACBSL_PID, and LKBSL_PID) 


e Several routines available for manipulating PIDs 


Table 3 Routines for Manipulating PIDs 





Operation | Mechanism 





Convert an extended PID to an internal PID § EXESEPID_TO_IPID 


‘Convert an internal PID to an extended PID EXESIPID_TO EPID 


Return the PCB address given an : EXESEPID_TO_PCB 
extended PID | 


Return the PCB address given an EXESIPID_TO_ PCB 
internal PID ie 
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Swapper’s Role in Process Creation 


PCB 


Figure [4 Swapper's Role in Process Creation 


@e For new process, WSSWP is less than or equal to zero 


@ WSSWP less than or equal to zero causes SHELL to be copied 


e Swapper 


~- . Stores SYSGEN parameters in PHD 


on EI 


- Initializes pointers, counters in PHD 
- Initializes system page table entries 


ai 
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PROCSTRYT’s Role in Process Creation 







New Process 





Control 
Region 





Process 
- Quota 
Block 










(PQB) 






Process 
Header 






Figure 15 PROCSTRT's Role in Process Creation 


9 Hardware PCB defined in SHELL 
@ PC and IPL invoke PROCSTRT at IPL 2 


@e Code located in SYS.EXE 


@ Functions 


PQB information moved to PHD and Pl 
Create logical name tables 

Change to user mode, IPL @ 

Map in FLIBXQP. 

Call SYSSIMGACT. 

Call image at transfer vector 
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INITIATING JOBS | | 
Initiating an Interactive Job © le Vy 


se 


as 









Caatest et Jee 
Caatretier Precese 


Caatest of Newly 
Greated Precsce 


LOGINOUT. EX 





@ lf net subprocess 








privileges, INC 
veername from UAF record 
© Set up process permanent files 


Figure l@ Initiating an Interactive Job 


e [Initiated by unsolicited input at a free terminal 


- Job controller notified by driver 
- Creates process with user name equal to terminal name 


@e LOGINOUT runs 


e DCL mapped (or alternate CLI) 


e SPAWN creates an interactive or non-interactive subprocess 
(mo need to verify user name, etc.) 
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ye 


Initiating Jol: Using $SUBMIT 








LOGINOUT. EXS 






1) Ne userneme/ password 
vertices 









2) SVSSIMPUT end SYSSOUTPUT 
are diferent : 





Figure Initiating Job Using SSUBMIT 


o Similar to interactive process, except 
- Job controller notified by DCL (S$SUBMIT) 
~- User already validated | 
- Files are assigned: 


SYSSINPUT to batch stream 
SYSSOUTPUT to log file 
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$ SUBMIT X.COM 





( 


SYSSOUTPUT 
SYSSERROR 


¢ 


Figure 








Initiating Job Through Card Reader 









SUBMIT utility ies 
CLI activates notifies Joo . Controtier J8CSYSQUE.DA 
SUBMIT utility | Contgiter poms 
=a a> 
process 
SYSSINPUT 
SYSSCOMMAND 


LOGiINOUT.EXE 


1) No username/password 
verification 


2} SYSSINPUT and SYSSOUTPUT 
are different 








BATCH.LOG 


MK 86-2777 


Initiating Job Through Card Reader 


1. Job controller notified by card reader driver 


2. Job controller creates input symbiont process 


"tes User authorization 
- Read cards into command file 
- Submit as batch job 


3. Same as for SSUBMIT 
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PROCESS DELETION 
| @ ap ce: imusecane and es (ee. cecceee deleted 
- Unless running with a CLI 
e All traces of process removed from system 
e All system resources returned 
@ Accounting information passed to job controller 
@ For subprocess, all quotas and limits returned to creator 


e Creator notified of deletion 


349 
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Process Deletion Sequence . 


OWNER 0O 









name BERT 






PID 00423 PID 00518 
Pe aaa ee eel eee Sts 
PRCCNT O PRCCNT O 

aera Pete | 





OWNER OO3AE OWNER OOSAE 


| Figure Process Deletion 





Oo Deleted by kernel AST while CURRENT 
Oo Sequence 


Delete any subprocesses 

Accounting information to job controller 
Call SYSSRUNDOWN 

Delete Pl space 

Free PCBVEC and SWAP slots, page file space 
Decrement counts 


Balance set 
Total processes 


- Jump to SCHSSCHED 
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SUMMARY: 
‘Table steps in Process Creation and Deletion 

Action Code 

Creating process SYSSCREPRC ~— hes trun fgmory 
: Ann Ah Cyt W7 or 

Inswap a process SWAPPER ern fren? & 

Process startup PROCSTRT 

Process deletion SYSSDELPRC 





Table SYSGEN Parameters Relating to Process eveatsen 
_ and Deletion 








Function ; ‘Parameter ae 
Maximum number of processes allowed on the | - | MAXPROCESSCNT 
system | 

System default values for some process Limits | PQL Dxxx 

and quotas . 

System minimum values for some process limits PQL Mxxx 

and quotas | = 
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. TOPICS 
te Process States 
A. What they are (current, computable, wait) 


B. How they are defined 


C. How they are related 


II. How Process States are Implemented in Data Structures 


A. Queues 


B. Process data structures 
IIr. The Scheduler (SCHED.MAR) a 
IV. Boosting Software Priority of Normal Processes 


Vv. Operating System Code that Implements Process State Changes 


A. Context switch (SCHED.MAR) 
B. Result of system event (RSE.MAR) 


VI. Steps at Quantum End 


A. Automatic working set adjustment 


VII. Software Priority Levels of System Processes 
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_ THE PROCESS STATES 


e  Gesds : 3 4 


1 : : 3 » F 
OGLETE (cum) (<u (ewe) <ie CREATE 
. (SCHEDULER) (SWAPPER) | 
Figure Process States 


1. CURRENT - executing 


Se 


2. WAIT - removed from execution to wait for event completion 
3. COMPUTABLE - ready to execute 
4. WAIT OUTSWAPPED 


5. COMPUTABLE OUTSWAPPED 


YY 











eon ” 
- N oy? yf er 
| UY 
uLING. i Hie a 
SCHED NG, ee nee 
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HOW PROCESS STATES ARE IMPLEMENTED 


Queues 







SQFL 
SQBL 








state 
"“listhead” 


Figure A State Implemented by a Queue 


e The state of a process is defined by: 


- The value in the PCBSW_STATE field 
- The PCB being in the corresponding state queue 


e State queues are circular 


e The current state is not implemented as a queue 


- Just a longword pointer (SCHSGL_CURPCB) 


- Queue structure not necessary because Bae one process 
' in the current state 


e VAX instructions for manipulating queues: 


- INSQUE new_entry, predecessor 
- REMQUE out_entry, return_address 


to 
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= implementation of COM and COMO States 


BITMAP a EACH FOR COM, como) 


FOR STATE COM 
BITS 31 00 
LONGWORD QUEUE SIT MAP 
::SCHSGL_.COMQS 
PRIORITIES 0 31 
LISTHEADS (32 EACH FOR COM, COMO) 
QUEUE HEADERS 


QUEUE 0 
PRIORITY 31 
1 

30 


::SCHSAQ_COMH 
::SCHSAQ_COMT 





TK-3974 


Figure Implementation of COM and COMO States 


@ COM state implemented as a collection of queues 


@ Designed to speed scheduler's search for highest-priority 
computable process 


- A queue for each software priority 
- Summary longword records nonempty COM queues 
- Internally, software priority stored as inverted value 


(as 31 minus priority) 


@ COMO state is implemented like COM state 


- 32 more queues 
- Another summary longword 
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ee ee 


BITS 31 | 0 


PRIORITIES 0 31 


PRIORITY 6 
PRIORITY 5 — 
PRIORITY 4 







QUEUE 25 
PRIORITY 6 





TK. 





Figure Example of Computable Queues 





® COM processes at priorities 4 and 6 
- Bit 25 in summary longword is set 
- Queue for priority 6 has entries 
. Bit 27 in summary longword is set 


- Queue for priority 4 has an entry 


7% 
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__.. Implementation of Wait States 





HIBERNATE PCBs PCB 


LISTHEAD 
TK-3952 
_ Figure Implementation of Wait States 
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implementation of CEF State 


§CH$GQ_.CEBHO:: = 





Figure Implementation of CEF State 


_@ CEB created when event flag cluster created | 

@ CEB contains the cluster, CEF state queue lListhead, and 
other information about the cluster 

@ One CEF state queue for each CEF cluster 
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— Summary of Scheduling States 


Current | | 
- Implemented with one longword pointer 


- Contains at most one process 


Computable and computable-outswapped 


- Each consists of a summary Longword, and 32 queues 
voluntary wait (LEF, LEFO, SUSP, SUSPO, HIB, HIBO) | 
- One queue for each state 


Involutary wait (PEW, PFWO, FPG, FPGO, COLPG, COLPGO, 
MWAIT, MWAITO) - | 


- In four queues 


- Resident and outswapped in same ‘queue (differentiate 
with resident bit in PCBSL_STS) 


- Usually not in these states very often 


o/ 


ae 
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Process Data Structures Related to Scheduling 





Figure Scheduling Fields in Software PCB 


SQFL, SQBL - state queve forward, backward links, link 
PCBs in a given state 

STATE - process state 

PRI = current software priority 

PRIB - base software priority 

PHYPCB - physical address of hardware PCB 

STS - process status 
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_. Saving and Restoring CPU Registers 


STACK POINTERS 
KESU 


PRS$_PCBB—> 











General Purpose 
Registers RO-R11 


. Cerro 


Tk OSS 


Figure Saving and Restoring CPU Registers 






@ Process-specific CPU registers saved/restored during 
context switch 


e SVPCTX instruction 
- Copies registers to hardware PCB 


- Switches to Interrupt Stack 
- Does not save PGBR, PGLR, PIBR, PLILR, ASTLVL 


@ - LDPCTX instruction 


- Restores registers (except PC, PSL) from hardware PCB 
- Pushes PC, PSL on kernel stack (REI removes them) © 
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Lg cupeminena (SCHED. MAR) 


BS 6 be + pe be bt Ot Ft pe 
OVOneUDSWNK SO VON US WN &X 


ta 


3 t2 to 
> bit) 


“ SCHSRESCHED - - - RESCHEDULING INTERRUPT HANDLER 
THIS ROUTINE IS ENTERED VIA THE IPL 3 RESCHEDULING INTERRUPT. 


3 

3 

q 

$ THE VECTOR FOR THIS INTERRUPT IS CODED TO CAUSE eaeeelton 

s ON THE KERNEL STACK. 

3 

3 ENVIRONMENT? IPLs3 MODE*KERNEL 1320 

s INPUTS 00(SP)=PC AT RESCHEDULE INTERRUPT 

$ O4(SP) SPSL AT INTERRUPT. 

joe 
eALIGN LONG 

MPHSRESCHED: ° sMULTI-PROCESSING CODE HOOKS IN HERE 

SCHSRESCHED? : sRESCHEDULE INTERRUPT HANDLER 
SETIPL SIPLS.SYNCH SSYNCHRONIZE SCHEDULER WITH EVENT REPORTING 
SYPCTX sSAVE CONTEXT OF PROCESS 
MOVL L“SCHSGL.CURPCB»R1 sGET ADDRESS OF CURRENT PCB 
MOVZBL PCBSBPRI(R1) »R2 _ SCURRENT PRIORITY 
BBSS R2eL“SCHSGL.COMQGS2108$ —=#MARK QUEUE NON-EMPTY 

1093 MOVW S#SCHSC.COMsPCBESW_STATEC(RI) sSET STATE TO RES COMPUTE 
MOVAQ SCHSAQ.COMTCR2ZI2R3 sCOMPUTE ADDRESS OF QUEUE ~ 
INSQUE (R1)7@(R3)4 SINSERT AT TAIL OF QUEUE 


3+ 

’ SCHSSCHED - SCHEDULE NEW PROCESS FOR EXECUTION 
3 

3 


THIS ROUTINE SELECTS THE HIGHEST PRIORITY EXECUTABLE PROCESS 


3 AND PLACES 
i= 
MPHSSCHED!?: 
SCHSSCHED: : 
SETIPL 
FFS 
BEQL 
MOVAG 
REMQUE 
BYVS 
BNEQ 
BBCC 


CMPS 
BNEQ: 
MOVW 
MOVE 
CMPB 


BEQL 
BBC 
INCS 


30s: move 


MTPR 
LDOPCTX 
RET 


SCHSIDLE: 
G SETIPL 
MOVB 
BRB 
QEMPTY: 


~END 


IT IN EXECUTION. 


sMULTI-PROCESSING CODE HOOKS IN HERE 
+SCHEDULE FOR EXECUTION 
#IPLS.SYNCH sSYNCHRONIZE SCHEDULER WITH EVENT REPORTING 


902832 rL“SCHSGL.COMGS »R2 sFIND FIRST FULL STATE 
SCHSIDLE sNO EXECUTABLE PROCESS?7? 
SCHSAQ_COMHCR21/R3 sCOMPUTE QUEUE HEAD ADDRESS 
@C(RI+9R4 sGET HEAD OF QUEUE 

QEMPTY jBR IF QUEVE WAS EMPTY (BUG CHECK) 
208 sQUEVE NOT EMPTY 


R29. “SCHSGL_CONQS» 208 ‘SET QUEUE EMPTY 


' @DYNSC.PCBPCBSB.TYPE(R4> sMUST BE A PROCESS CONTROL BLOCK 


QEMPTY sOTHERWISE FATAL ERROR 
#SCHSC_CUR»PCBESHY_STATE(R4) *SET STATE TO CURRENT 
R4eL“SCHSGL._CURPCB sNOTE CURRENT PCB LOC 
PCBSB_PRIB(R4) »PCBSBLPRI(R4) sCHECK FOR BASE 
*PRIORITY*SCURRENT 
308 sYES» DONT FLOAT PRIORITY 
#4ePCBSB_PRI(R4) 2308 sDONT FLOAT REAL TIME PRIORITY 
PCBSB_PRI(R4) . sMOVE TOWARD BASE PRIO 
PCBSSB_PRI(R4) »L“SCHSGB_PRI | sSET GLOBAL PRIORITY 
PCBSL_PHYPCB(R4) » S¢PRS_PCBB *SET PCB BASE PHYS ADDR © 


sRESTORE CONTEXT 
SNORMAL RETURN 


3NG ACTIVEs EXECUTABLE PROCESS 


#IPLs$_SCHED | sDROP IPL TO SCHEDULING LEVEL 
#32rL°SCHSGB_PRI sSET PRIORITY TO -1(32) TO SIGNAL IDLE 
SCHSSCHED SAND TRY AGAIN 


BUG CHECK QUEUEMPTY» FATAL sSCHEDULING QUEUE EMPTY 


Example The Scheduler (SCHED.MAR) 
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BOOSTING SOFTWARE PRIORITY OF NORMAL PROCESSES 
Usually normal interactive process has base priority 4 
@ To help interactive processes compete with compute-bound 


processes : 


- Boosts applied upon certain events (1/0 completion, 
resource available) 


- Different boosts for different events 


- Current priority equals greater of: 


@® Current priority 
e@ Base priority plus boost 
- Lowering of priority 


e Each time process scheduled, decrement priority 
(until reach base priority) 

@e Return to base priority at quantum end if - COMO 
process exists ; 


- Hoe et roves to boost above normal priority range 
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Example of Process Scheduling 
Table 1 Initial Conditions for Scheduling Example 
Process Type Base Priority Priority State 
Swapper System . 16 16 HIB 
Null Compute Bound | g COM 
A Compute Bound — 4. 9 | CUR 
I/O Bound 4 1d COMO 
Real-Time 18 18 HIB 


ro) 





Symbol Event 


(’) 1/0 Request 
(*) Preemption — 
(a) Quantum End 


MKV84-2181 





-Figure 15 Scheduling Example Symbols 
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Figure Example of Process Scheduling - Part 1 


Process C becomes computable. Process A is preempted. 


C hibernates. A executes again, one priority level lower. 


A experiences quantum end and is rescheduled at its base 
priority. B is computable outswapped. 


The Swapper process executes to inswap B. Bis scheduled 


for execution. 
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Quantiae 
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' Figure | Example of Process Scheduling - Part 2 


B is preempted by C. 


B executes again, one priority level lower. 


B requests an [I/O operation (not terminal T/O). 


executes at its base priority. 


A 


A requests a terminal output operation. The null process 


executes. 


A executes following I/0 completion at its base priority 


Plus 3. (The applied boost was 4.) 
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Figure - Example of Process Scheduling - Part 3 


A is preempted by C. 
A executes again, one priority level Lower. 


A experiences quantum end and is rescheduled at one 
priority level lower. 


A is preempted by B. A priority boost of 2 is not applied 
to B because the result would be less than the current 
priority. 


B is preempted by C. 
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Figure Example of Process Scheduling - Part 4 


15. B executes again, one priority level lower. 


16. B requests an [I/O operation. A executes at its base 
priority. | 


17. A experiences quantum end and is rescheduled at the same 
Priority (its base priority). 


18. A is preempted by C. 


Go 
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__ IMPLEMENTATION OF PROCESS STATE CHANGES 


Table Operating System Code for Scheduling Functions 








Function | Module ‘ Routines 
Change between CUR and COM SCHED.MAR SCHSRESCHED 
SCHSSCHED 
: 
| Move between resident and SWAPPER.MAR SWAPSCHED 
outswapped . . INSWAP 
: OUTSWAP 
Move in and out of wait RSE.MAR SCHSRSE 
‘ states — i SCHSUNWAIT 


(and others) 


Quantum end processing RSE .MAR SCHSQEND 
a meneame eer SY 





o/ 








SCHEDULING 






















Process A Process B Process C 
Per Process 
Space 
Process 
Context 
System 
Space 
Process 
_ Context 
CONTEXT 
System Switch 
Space . 
System : ‘3 SCHEDULER FF 
Context Sean OE sevon: INTERRUPT 
. SET EVENT FLAG bs SERVICE 
WAKE ROUTINE f& 
RESUME e 


Figure Interaction of Scheduling Components 
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ieee System Event Conmonsit (RSE.MAR) 


l. Syaten aeenes: cause transitions between process states. 


2. These transitions are accomplished by the code in RSE.MAR. 


3. Inputs to RSE 
a. PCB address 


b. Event number (number for WAKE, CEF SET, and so on) 


4. RSE flow 


a. Event checked for significance (for example, WAKE only 
if in HIBER state). 


b. PCB removed from wait queue and wait queue _header . 
count decremented. — | a 


GC. PCB inserted on COM or COMO state queue after priority 
adjustment, and summary bit set. 


d. Swapper process can be awakened (if PCB was inserted 
on COMO queue). 


e. Scheduler interrupt at IPL 3 requested if the new 


computable process has software priority greater than 
that of current process. 
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STEPS AT QUANTUM END 
Real-Time Process 


l. 
2. 


Reset PHDSB_QUANT to full quantum value. 
Clear initial quantum bit PCBSV_INQUAN in PCBSL_STS. 


Normal Process 


1. 
2. 


3. 


4. 


5. 


Reset PHDSB_ QUANT to full quantum value. 
Clear initial quantum bit PCBSV_INQUAN in PCBSL_sTs. 


If any outswapped process computable, set current software 
priority PCBSB_PRI to base priority PCBSB_PRIB. 


If SWAPPER needed, wake SWAPPER. 


.IT£ CPU limit imposed, and limit has expired, queue AST to 


process for process deletion. 


If not, then calculate automatic working set seleecate, 


Request scheduling interrupt at IPL 3. 
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Automatic Working Set Adjustment 


Goal: optimal working set size 

- Large enough to allow good program per formance 

- Small enough to optimize overall memory usage 
Adjustment calculated at quantum end | 

- If high paging rate, want to increase working set size 


- I£ low paging rate, may want to decrease working set 
size (take back some physical memory) 


Usually gives large increases, small decreases 


. Only affects the list size, not the number of entries in 


use 


No adjustment done for real-time processes 


Can disable adjustment for normal processes 


- Perprocess: $ SET WORKING SET/NOADJUST 
- System-wide: SYSGEN> SET WSINC @ 
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-- Automatic Working Set Adjustment 


PAGE 
FAULT 
RATE 





| aan ery 


MINWSCNT 


WORKING SET SIZE 
. TK 4008 
Pigure Automatic Working Set Adjustment. 


6b 


SCHEDULING 


- Rules for Working Set Adjustment 
l. If PERATL < PFRate < PFRATH, no adjustment is necessary. 


2. If PFRate > PFRATH then perhaps WSSIZE = WSSIZE + WSINC. 
- WSSIZE can grow to WSQUOTA anytime 


- WSSIZE can grow to WSEXTENT if free pages > BORROWLIM 


3. If PFRate < PFRATL then perhaps WSSIZE = WSSIZE - WSDEC. 
- WSSIZE can shrink to AWSMIN (no smaller) 


Example 2 Working Set Adjustment Algorithm 
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. Example of Working Set Size Variation 


- AWSMIN 
MINWSCNT 





TK-9012 


Figure © WSSIZE Variation Over Time 
Table. Reasons for Working Set Size Variations 

Time Reason for WSSIZE Change 
a Page faults > PFRATH 

Free page count > BORROWLIM 
b Page faults < PFRATL 
c Page faults < PFRATL 
dq Page faults > PFRATH 

Free page count < BORROWLIM 
e Page faults > PFRATH 

Free 


page count > BORROWLIM 
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Forcing Processes to Quantum End 


@ 


2 ee ee 





4. a om om @ o& oe 


— IOTA 


Se fale “| 


" Context 
\ Switch 


Program A 





Figure Use of the IOTA System Parameter — 


e IOTA = special system parameter (in 14 ms units) 


@e Deduct IOTA units from time quantum when process enters 
wait state 


@ Used to force processes to quantum end 


@ Not charged to process CPU limit | 
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SOFTWARE PRIORITY LEVELS OF PROCESSES 


Table. Software Priority Levels of Processes on VMS | 
ee eae emmmramamaanea ata 





Base 7 
Process Priority Purpose 
NOLL G. Consume idle CPU time 
default user . 4 User activities 
SYMBIONT_n -4 Input/output symbiont 
OPCOM 6 Operator communications 
ODS-1 disk ACPs 8 ODS-1 disk file structure 
Tape ACPS 8 Tape file structure 
ERRFMT 7 Write error log buffers 
JOB_CONTROL 8 Queue and accounting manager 
NETACP 8 DECnet ACP ; 
REMACP 8 Remote ACP 
SWAPPER «16 System-wide memory manager 





e Base priority of process determined by argument to SCREPRC 
system service 


@ ‘Base priority of system processes 
- Most are established during system initialization 


- Base priority of ACPs is controlled by ACP_BASEPRIC 
system parameter. 


@® Normal processes receive priority boosts 


10 








SCHEDULING 


Table SYSGEN parameters Relevant to Scheduling 


‘Function Parameter 
Base priority for Ancillary Control Processes ACP_BASEPRIO 
Minimum number of working set pages AWSMIN 
Minimum amount of time that must elapse for AWSTIME 


significant sample of a process page fault rate 


Minimum number of pages required on free page BORROWLIM 
list before working sets are allowed to grow 
beyond WSQUOTA (checked at quantum end) 


Base default priority for processes DEF PRI 

Time alloted to each of a process's exit EXT RAC PU 
handlers after CPU limit expjres 

Amount of time to deduct from process quantue IOTA (*) 

for each voluntary wait 

Minimum number of fluid working set pages MINWSCNT 

Page fault rate above which VMS attempts PF RATH 


to increase the process working set size 


Page fault rate below which VMS attempts PFRATL 
to decrease the process working set size 


Max imum smeadt of CPU time a normal process can QUANTUM 
receive before control passes to a computable 
process of equal priority 


Number of pages for working set size decrease WSDEC 


Number of pages for working set size increase WSINC 
Maximum number of pages for any working set WSMAX 





(*) = special SYSGEN parameter 


7/ 
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$ SHOW MEMORY 


System Memory Resources on 20-JUL-1986 15:47:08.74 


Physical Memory Usage (pages): Total 
Main Memory (4.00Mb) 8192 
Slot Usage (slots): Total 
Process Entry Slots 19 
Balance Set Slots 17 
Fixed-Size Pool Areas (packets): Total 
Small Packet (SRP) List 133 
I/O Request Packet (IRP) List 81 
Large Packet (LRP) List 14 


Dynamic Memory Usage (bytes): , "Total 
Nonpaged Dynamic Memory %" « ¥ ¢222208 


Paged Dynamic Memory (usr Rime 105472 
; “ave 


Paging File Usage (pages): 
DISKSVMS:[SYS0.SYSEXE]SWAPFILE.SYS 
DISKSVMS: [SYS0.SYSEXE]PAGEFILE.SYS 


Free 
5852 


Free 
12 
12 


Free 
16 

8 

5 


Free 
54880 
36560 


Free 
4752 
6662 


In Use 
2278 


Resident - 


7 
5 


In Use 
117 

73 

9 


In Use 
167328 
68912 


In Use 
1248 
338 


Modified 
62 


Swapped 
0 
0 


Size 

96 

208 
1584 


Largest 
50624 
35632 


Total 
6000 
7000 


Of the physical pages in use, 1416 pages are permanently allocated to VMS. 
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$ SHOW MEMORY/POOL/FULL 


System Memory Resources on 20-JUL-1986 16:13:10.81 


Small Packet (SRP) Lookaside wee 


Current Total Size 


yy 


‘ S- ve 
Initial Size (SRPCOUNT) °° ‘ ve 


Maximum Size (SRPCOUNTV) 
Free Space 
Space in Use 


Packet Size/Upper Bound (SRPSIZE) 


Lower Bound on Allocation 


I/O Request Packet (IRP) Lookaside List 


Current Total Size 
Initial Size (IRPCOUNT) 
Maximum Size (IRPCOUNTV) 
Free Space 
-Space in Use 


Packet Size/Upper Bound (fixed) 


Lower Bound on Allocation 


Large Packet (LRP) Lookaside List 


Current Total Size 
Initial Size (LRPCOUNT) 
Maximum Size (LRPCOUNTV) 
Free Space — 

Space in Use 


Packet Size/Upper Bound (LRPSIZE + 80) 


Lower Bound on Allocation 


Nonpaged Dynamic Memory 
Current Size (bytes) 
‘Initial Size (NPAGEDYN) 
Maximum Size (NPAGEVIR) 
Free Space (bytes) 

Size of Largest Block 
Number of Free Blocks 


Paged Dynamic Memory 
Current Size (PAGEDYN) 
Free Space (bytes) 
Size of Largest Block 
Number of Free Blocks 


222208 
222208 
667648 
54880 
50624 
7 


105472 
36560 
35632 

6 
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Packets 
133 

60 

3000 

17 

116 


Packets 


Packets 
14 


8. 


60 
5 
9 


Bytes 
12768 


5760: 


288000 
1632 
11136 
96 

32 


Bytes 
17264 
6240 
416000 
2080 


15184 © 


208 
97 


Bytes 
22176 
12672 
95040 
7920 
14256 

1584 

1088 


Current Total Size (pages) 
Initial Size (pages) 
Maximum Size (pages) 
Space in Use (bytes) 
Size of Smallest Block 
Free Blocks LEQU 32 Bytes 


Current Total Size (pages) 
Space in Use (bytes) 

Size of Smallest Block 
Free Blocks LEQU 32 Bytes 


Pages 
34 

13 
813 


Pages 
44 
25 
186 . 


434. 
434 
1304 
167328 


206 
68912 
48 


S$ ANALYZE/SYSTEM 


VAX/VMS System analyzer 


SDA> SHOW 


SUMMARY 


Current process summary 


Extended 


-- PID -- ---- --------------- ----------- ----- 225 222 ----- -------- ----- | 


00000020 
00000021 
00000024 
00000026 
00000027 
00000028 
00000028 


SDA> SHOW 


NULL 
SWAPPER 
JOB_CONTROL 
NETACP 

EVL 

REMACP 
SYSTEM 


SUMMARY / IMAGE 


Current process summary 


Extended 
-- PID 
00000020 
00000021 
00000024 
00000026 
00000027 
00000028 


‘00000028 


0000 NULL 
0001 SWAPPER 
0004 JOB CONTROL 


DUAO: [SYSO.] [SYSEXE ]JOBCTL. EXE; 2 


0006 NETACP 


DUAO:(SYSO. ][SYSEXE]NETACP.EXE;6 


0007 EVL 


Username 


SYSTEM 
DECNET 


. DECNET 


SYSTEM 
SYSTEM 


Username 


SYSTEM 
DECNET 


DECNET 


DUAO: [SYSO. ] [SYSEXE]EVL. EXE 


0008 REMACP 


DUAO: [SYSO.]([SYSEXE]REMACP.EXE;3 


000B SYSTEM 


SYSTEM 


SYSTEM 


DUAO:[SYS0. ][SYSEXE]SDA. EXE; 2 


State Pri 
COM 0 
HIB 16 
HIB 8 
HIB 10 
HIB 5 
HIB ..13 
CUR 5 

State Pri 
COM 0 
HIB 16 
HIB 8 
HIB 10 
HIB 6 
HIB 13 
CUR 4 


800024A8 
80002748 
801093C0 
80112A50 
801130F0 
8011A020 
8010E3D0 


800024A8 
80002748 
801093C0 


"80112A50 


801130F0 
8011A020 
8010E3D0 


80002328 
800025C8 
8026C000 
8027BA00 
8029AE00 
802AA800 
8028B400 


80002328 
800025C8 
8026C000 


8027BA00 | 


8029AE00 
802AA800 
8028B400 
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SDA> SHOW PROCESS/PCB 


Process index: 000B Name: SYSTEM Extended PID: 0000002B 


Process status: 02040001 RES , PHDRES 
PCB address 8010E3D0 JIB address 801C2320 
PHD address 8028B400 Swapfile disk address 01000361 


Master internal PID 0001000B Subprocess count 0 

Internal PID 00010008 Creator internal PID 00000000 

Extended PID 0000002B Creator extended PID 00000000 

State CUR Termination mailbox 0000 

Current priority 4 AST's enabled KESU 

Base priority . 4 AST's active NONE 

UIC [00001,000004] AST's remaining 21 

Mutex count 0 Buffered I/O count/limit 18/18 
Waiting EF cluster ‘ 1 Direct I/O count/limit 18/18 
Starting wait time 1BOO1BI1A BUFIO byte count/limit 20128/20128 
Event flag wait mask 7FFFFFFF-, # open files allowed left LS: * 

Local EF cluster 0 E0000003 Timer entries allowed left 20 

Local EF cluster 1 c0000000 Active page table count 0 

Global cluster 2 pointer 00000000 Process WS page count 668 

Global cluster 3 pointer 00000000 Global WS page count ., 2.4, 2 Resor ere witr 
Loow AT THs fe you fra. WAY mae fr DD BESS Wire RYCEEDS 


| > ADDRESS OF Ar SHR Sid PHOLE (Murex ) anid 
SDA> SHOW PROCESS/PHD IT WR warren FOR + 
VE Num&in id, , Hs Br ‘ ae 
Process index: 000B Name: SYSTEM Extended PID: 0000002B (Mba Avr vole dk 
a eacttentaee ee toenail ionetoee toon ioe enten eienntoeatoatrebeetenToasteenteteertenteniiententeatententententeteneestertetetenkententeatententaaten ae ce Vrwwwdnn - Aw 


ia 


we ee ew ee winx i a a ha 
First free PO address 000A5800 Accumulated CPU time QOOQ00ESA 
Free PTEsS between P0Q/P1 10699 CPU since last. quantum FFF9 
- First free Pl address 7FFSEEOO Subprocess quota 10 
Free page file pages 8896 AST limit 24 
Page fault cluster size 16 Process header index 0002 
Page table cluster size 2 Backup address vector OOO009BF 
Flags 0002 WSL index save area 00000980 
Direct I/O count 156 PTs having locked WSLs 5 
Buffered I/O count 845 PTs having valid WSLs 18 
Limit on CPU time 00000000 Active page tables 21 
Maximum page file count 10000 Maximum active PTs 21 
Total page faults 3628 Guaranteed fluid WS pages 20 
File limit 20 Extra dynamic WS entries 282 
Timer queue limit 20 Locked WSLE counts array 28F0 
Paging file index 03000000 Valid WSLE counts array 2958 


SDA> SET PROCESS/INDEX=28 
SDA> SHOW PROCESS/PCB 


Process index: 0008 Name: 


RES , NOACNT , PHDRES , LOGIN 


Process status: 00148001 
PCB address 8011A020 
PHD address 802AA800 


Master internal PID 00010008 
Internal PID 00010008 
Extended PID 00000028 
State HIB 
Current priority 13 
Base priority 8 
UIC [00001,000003] 
Mutex count Q 
Waiting EF cluster om 
Starting wait time 17001717 
Event flag wait mask 7FFFFFFF 
Local EF cluster 0 E0000000 
Local EF cluster 1 00000000 


Global cluster 2 pointer 00000000 
Global cluster 3 pointer 00000000 


SDA> SHOW PROCESS/PHD 
0008 Name: 


Process index: REMACP 


REMACP Extended PID: 00000028 


JIB address 801C2730 
Swapfile disk address 010004E1 
Subprocess count 0 


First free PO address 00008200 
Free PTES between P0Q/P1l 12455 
First free Pl address 7FF9D000 
Free page file pages 1594 
Page fault cluster size 16 
Page table cluster size 2 
Flags 0006 
Direct I/O count 2 
Buffered I/O count 2) 
Limit on CPU time 00000000 
Maximum page file count 2048 
Total page faults 64 
File limit 70 
Timer queue limit 8 
Paging file index 03000000 


TR 


Creator internal PID 00000000 
Creator extended PID 00000000 
Termination mailbox 0000 
AST's enabled KESU 
AST's active NONE 
AST's remaining 99 
Buffered I/O count/limit 65534/65535 
Direct I/O count/limit 18/18 
BUFIO byte count/limit 62783/62783 
# open files allowed left 69 
Timer entries allowed left 8 
Active page table count 0 
Process WS page count 30 
Global WS page count 0 
Extended PID: 00000028 
Accumulated CPU time OOOQ000F 
CPU since last quantum 0005 
Subprocess quota 8 
AST limit 100 
Process header index 0004 
Backup address vector OOO0009BF 
WSL index save area 00000980 
PTs having locked WSLs 6 
PTs having valid WSLs 6 
Active page tables 8 
Maximum active PTs 8 
Guaranteed fluid WS pages 20 
Extra dynamic WS entries 149 
Locked WSLE counts array 28F0 
Valid WSLE counts array 2958 


SDA> SHOW POOL/SUMMARY 


Summary of IRP lookaside list 


53 FCB = 11024 (68%) 
10 IRP 2 2080 (13%) 
1 NET = 208 (13%) 
2 CXB = 416 (2%) 
5 JIB = 1040 (6%) 
5 RSB = 1040 (6%) 
1 INIT = 208 (1%) 


Total space used 16016 out of 17264 total bytes, 1248 bytes left 


Total space utilization = 92% 


Summary of LRP lookaside list 


12672 (89%) 
1584 (11%) 


8 CXB 
Ll CDB 


Total space used = 14256 out of 22176 total bytes, 7920 bytes left 


Total space utilization = 64% 


Summary of SRP lookaside list 


2 AQB = 192 (1%) 
8 CRB = 768 (6%)- 
7 DDB = 672 (5%) 
8 IDB = 768 (6%) 
4 TQE = 384 (3%) 
50 WCB = 4800 (413%) 
5 BUFIO = 480 (4%) 
1 NET = 96 (0%) 
1 PTR - 96 (0%) 
17 LKB = 1632 (14%) 
12 RSB = 1152 (9%) 
3 scs = 288 (2%) 
3 INIT = 288 (2%) 


Total space used 11616 out of 12768 total bytes, 1152 bytes left 


Total space utilization = 90% 


Summary of non-paged pool contents 


3 


PHRWRPYRP PN PWONRPN SOE E NAY 


Total 


Total 


Summary of paged 


5 : 


1 
11 
19 

1 

i 
14 

a 

1 

af 
40 

a, 

1 


Total 


Total 


UNKNOWN 
ADP 

AQB 

LOG 

PCB 

UCB 

VCB 
TYPAHD 
NET 

DPT 

RBM 

VCA 

CDB 

LKID 
RSHT 

SCS 
LOADCODE 
INIT 
CLASSDRV 
UIS 


space used 


UNKNOWN 
PQB 
GSD 
KFE 
MTL 
NDB 
KF RH 
TWP 
RSHT 
XWB 
LNM 
KFPB 
CIA 


space used 


space utilization = 


space utilization = 


19600 
1792 
32 

32 
1440 
11584 
480 
368 
13152 
93488 
3728 
864 
736 
400 
272 
5904 
2752 
9840 
oie 
352 


167328 out of 222208 total bytes, 


—” 


ee ee a et ate et ee 
OOM WODOONNNAIHODOOWDOAODDOF Ff 
GO dO dO dP dP dP dP dO dP d© U1 dP dP dO dP dP dP dO ade + 


Nee er et ee ee ee ee ee ee ee "we we wee we we we es So" 
~~ 


54880 bytes left 


75% 


pool contents 


23232 (333%) 
°2256 (3%) 
528 (0%) 
1232 (1%) 
32 (0%) 
2544 (3%) 
4160 (6%) 
12336 (17%) 
528 (0%) 
16384 (23%) 
3104 (4%) 
16 (0%) 
2560 (3%) 
68912 out 


of 105472 total bytes, 36560 bytes left 


65% 


RO 


DATA STRUCTURE TYPE DEFINITIONS 


ACB AST CONTROL BLOCK 

ACL ACCESS CONTROL LIST QUEUE ENTRY 

ADP UNIBUS ADAPTER CONTROL BLOCK 

AQB ACP QUEUE BLOCK 

BRDCST BROADCAST MESSAGE BLOCK 

BUFIO BUFFERED I/O BLOCK 

CDB X25 LES CHANNEL DATA BLOCK 

CDRP CLASS DRIVER REQUEST PACKET 

CEB COMMON EVENT BLOCK 

CHIP Internal CHKPRO block 

CI CI PORT SPECIFIC (*** See Subtypes Below ***) 
CIA Compound Intrusion Analysis block 

CIDG DATAGRAM BUFFER FOR CI PORT 

CIMSG — MESSAGE BUFFER FOR CI PORT 

CLASSDRV CLASS DRIVER MAJOR STRUCTURE (*** See Subtypes Below ***) 
CLU CLUSTER MAJOR STRUCTURE (*** See Subtypes Below ***) 
CRB CHANNEL REQUEST BLOCK 

CXB COMPLEX CHAINED BUFFER 

DCCB Data Cache Control Block 

DDB DEVICE DESCRIPTOR BLOCK 

DPT DRIVER PROLOGUE TABLE 

DSRV | Disk Server structure type (*** See Subtypes Below ***) 
ERP ERRORLOG PACKET 

EXTGSD EXTENDED GLOBAL SECTION DESCRIPTOR 

FCB FILE CONTROL BLOCK 

FLK Fork Lock Request Block 

FRK FORK BLOCK 

GSD GLOBAL SECTION DESCRIPTOR BLOCK 

IDB INTERRUPT DISPATCH BLOCK 

INIT STRUCTURES .SET UP BY INIT (*** See Subtypes Below ***) 
‘IRPE I/O REQUEST PACKET Eee 

IRP I/O REQUEST PACKET 

JIB JOB INFORMATION BLOCK 

JPB JOB PARAMETER BLOCK 

KFD Known File Device Directory block 

KFE KNOWN FILE ENTRY 

KFPB Known File list Pointer Block 

KFRH KNOWN FILE IMAGE HEADER 

LKB LOCK BLOCK 

LKID LOCK ID TABLE 

LNM LOGICAL NAME BLOCK 

LOADCODE LOADABLE CODE | (*** See Subtypes Below ***) 
LOG LOGICAL NAME BLOCK 

LPD X25 LES PROCESS DESCRIPTOR 

MBX MAILBOX CONTROL BLOCK 

MP ASMP related structure (*** See Subtypes Below ***) 
MTL MOUNTED VOLUME LIST ENTRY 

MVL MAGNETIC TAPE VOLUME LIST 

NDB NETWORK NODE DESCRIPTOR BLOCK 

NET NETWORK MESSAGE BLOCK . 

ORB Objects Rights Block 

PBH PERFORMANCE BUFFER HEADER 

PCB PROCESS CONTROL BLOCK 

PDB PERFORMANCE DATA BLOCK 
 PFB Page Fault Monitor Buffer 

PFL PAGE FILE CONTROL BLOCK 


PGD PAGED DYNAMIC MEMORY (*** See Subtypes Below ***) 
R 4 | 


PIB PERFORMANCE INFORMATION BLOCK 

PMB Page Fault Monitor Control Block 

PQB PROCESS QUOTA BLOCK 

PTR POINTER CONTROL BLOCK 

QVAST QVSS AST block 

RBM Realtime SPT bit map 

RIGHTSLIST RIGHTS LIST 

RSB RESOURCE BLOCK 

RSHT RESOURCE HASH TABLE 

RVT RELATIVE VOLUME TABLE 

scs SYSTEM COMMUNICATION SERVICES(*** See Subtypes Below ***) 
SHB SHARED MEMORY CONTROL BLOCK 

SHMCEB SHARED MEMORY MASTER COMMON EVENT BLOCK 
SHMGSD SHARED MEMORY GLOBAL SECTION DESCRIPTOR 
SLAVCEB SLAVE COMMON EVENT BLOCK 

SSB LOGICAL LINK SUBCHANNEL STATUS BLOCK 
TQE TIMER QUEUE ENTRY 

TWP Terminal driver write packet 

TYPAHD TERMINAL TYPEAHEAD BUFFER 

UCB UNIT CONTROL BLOCK 

UIS UIS Structure (*** See Subtypes Below ***) 
VCA Disk volume cache block 

VCB VOLUME CONTROL BLOCK 

WCB WINDOW CONTROL BLOCK 

WOE DECNET WORK QUEUE BLOCK 

AWB DECNET LOGICAL LINK CONTEXT BLOCK 


SUBTYPE CODES . ; 


CODES THAT ARE SUBTYPABLE REFER TO A GENERIC FUNCTION AND WITHIN THAT 
FUNCTION THERE MAY BE MANY DIFFERENT SUB-TYPES OF BLOCKS. 


THE SUB-TYPE IS IN THE 12TH BYTE. 


SCS 
SCS_CDL CONNECT DISPATCH LIST 
SCS_CDT CONNECT DISPATCH TABLE 
SCS DIR DIRECTORY BLOCK 
SCS_PB PATH BLOCK 
SCS PDT PORT DESCRIPTOR TABLE 
SCS_RDT REQUEST DESCRIPTOR TABLE 
SCS_SB SYSTEM BLOCK 
SCS_SPPB SCA POLLER PROCESS BLOCK 
SCS_SPNB SCA POLLER NAME BLOCK 

ei CI PORT SPECIFIC 
CI_BDT BUFFER DESCRIPTOR TABLE 
CI_FQDT FREE QUE DESCRIPTOR TABLE 
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LOADCODE LOADABLE CODE 


NON PAGED NON PAGED CODE 


PAGED PAGED CODE 

LC MP MULTIPROCESSOR CODE 
LC_Scs SCS CODE» 

LC CLS CLUSTER CODE 


LC CHREML CHAR/DECIMAL INS EMUL 
LC FPEMUL FLOAT PNT EMULATOR 


.LC_MSCP = .MSCP SERVER 
LC_SYSL SYSLOA 
INIT STRUCTURES SET UP BY INIT 
PCBVEC PROCESS CONTROL BLOCK VECTOR 
PHVEC PROCESS HEADER VECTOR 
SWPMAP SWAPPER MAP 
MPWMAP. MODIFIED PAGE WRITER MAP 
PRCMAP PROCESS BITMAP 
BOOTCB BOOT CONTROL BLOCK 
CONF CONFIGURATION ARRAYS 
CST CLUSTER SYSTEM TABLE 
CLASSDRV CLASS DRIVER MAJOR STRUCTURE TYPE CODE | 
CD_CDDB CLASS DRIVER DATA BLOCK 
CD_BBRPG BAD BLOCK REPLACEMENT PAGE | 
CD _SHDW_WRK SHADOW SET WORK BUFFER 
CLU CLUSTER MAJOR STRUCTURE TYPE CODE 
CLU_CSB CONNECTION STATUS BLOCK | 


CLU_CLUVEC CLUSTER SYSTEM VECTOR 

CLU_CLUB CLUSTER BLOCK 

CLU_BTX CLUSTER BLOCK TRANSFER EXTENSION 
CLU_CLUDCB CLUSTER DISK QUORUM CONTROL BLOCK 


CLU CLUOPT ‘CLUSTER OPTIMAL RECONFIGURATION CONTEXT BLOCK 


CLU LCKDIR LOCK MANAGER DISTRIBUTED DIRECTORY VECTOR 


PGD PAGED DYNAMIC MEMORY 


OS ED ED AD ED SET GED SD AED SEED ED ERD SED. c SEED SD <ceD EED Om ne eine UD ED eS RE ee EE Se ee ES ES oD CEE ES GD ee ED eS ee eee ee ee ee ee ee ee 


PGD_ FIIBC F1I1BXQP BUFFER CACHE. 


UIS UIS Structure 
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DSRV Disk Server structure type 
DSRV_DSRV Disk server structure 
DSRV_HQB Host Queue Block 
DSRV HRB Host Request Block 
DSRV_IOBUF Server local I/O Buffer 
DSRV_UQB Unit Queue Block. 


MP ASMP related structure 


MP_CONSARRY Logical Console Array 
MP_CONSBFCTL Logical Console Buffer 


Extracting the Structure Code Values 


§ LIBRARY/MACRO/EXTRACT=S$DYNDEF/OUTPUT=DYNDEF.MAR SYSSLIBRARY:LIB.MLB 


$DYNDEF 
SEQU DYNSC_ADP 1 
SEQU DYNSC_ACB 2 
SEQU DYN$C_AQB 3 
$EQU DYNSC_CEB 4 
. SEQU DYNSC_CRB 5 
SEQU DYNSC_DDB 6 
SEQU = DYNSC_FCB 7 
_$EQU DYNSC_FRK 8 
SEQU DYNSC_IDB 9 
SEQU DYNSC_IRP 10 
SEQU DYNS$C_LOG it 
SEQU DYNSC_RIGHTSLIST. 66 
SEQU DYNSC_LOADCODE 98 
SEQU DYNSC_NON PAGED 1 
$EQU DYNS$C_ PAGED 2 
SEQU DYNS$C_LC_MP 3 
$EQU DYNSC_LC_SCS 4 
SEQU DYNSC_LC CLS 5 
SEQU DYNSC_LC CHREML 6 
SEQU DYNSC_LC FPEMUL 7 
SEQU DYNSC_LC MSCP 8 
9 


SEQU DYNSC_LC_SYSL 


SDEFEND DYN,SGBL,DEF 
. ENDM 


7. 


